Skip to content

add fr getting started page #2245

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
Dec 6, 2021
Merged

Conversation

apointeau
Copy link
Contributor

No description provided.

@eed3si9n
Copy link
Member

eed3si9n commented Dec 2, 2021

@apointeau Thanks for the contribution. I can't review this myself, but I created @scala/docs-fr team who might be able to. Maybe you could ping other French speakers you know of.

@apointeau
Copy link
Contributor Author

@eed3si9n Hello, the page you link "@scala/docs-fr" results to a 404 error for me. I'm not very familiar with the contribution world, so it's hard for me to find someone else to review. I planed to traduct all the tour in french and some other pages. I took the time I need for high quality traduction, I hope that the review will be "easy".

@eed3si9n
Copy link
Member

eed3si9n commented Dec 2, 2021

I used to be able to add random ppl on the GitHub team, but I seem to have lost the authorization to do so. I'm going to mention a few ppl.

@Duhemm, @alexarchambault, @julienrf, @jto, @jeantil, @xbucchiotty, @Viewtiful Let us know if you could review French documentation translation. If you don't I'll find a Canadian person who would and you won't like it.

@jeantil
Copy link
Contributor

jeantil commented Dec 2, 2021

It reads mostly ok for me. I suggested a few changes to fix typos mostly.

@eed3si9n
Copy link
Member

eed3si9n commented Dec 2, 2021

Un grand merci Jean! Antoine has opened like 8 PRs so maybe you and others could take a look at those too (it's late so later probably)? 🙏 https://github.com/scala/docs.scala-lang/pulls

@apointeau
Copy link
Contributor Author

@jeantil Thank you very much, there was many small dumb mistakes, I will try to better reread the next times.

@jeantil
Copy link
Contributor

jeantil commented Dec 3, 2021

@apointeau thanks for your work, it's always easier to spot these when you didn't write them :)

Copy link
Contributor

@mlachkar mlachkar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

La traduction est vraiment superbe! Merci beaucoup pour votre travail!

Copy link
Contributor

@mlachkar mlachkar left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks again!

@mlachkar mlachkar merged commit 1d7f184 into scala:main Dec 6, 2021
Copy link
Contributor

@Duhemm Duhemm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've found a few typos and made a few suggestions. Thanks @apointeau !


1. `cd` dans un répertoire vide.
1. Lancez la commande `sbt new scala/scala3.g8` pour créer un projet Scala 3, ou `sbt new scala/hello-world.g8` pour créer un projet Scala 2.
Cela va télécharger un projet template depuis Github.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Cela va télécharger un projet template depuis Github.
Cela va télécharger un projet modèle depuis Github.

En plus de gérer les JVMs, `cs setup` installe aussi des utilitaires en ligne de commande :

- Un JDK (si vous n'en avez pas déjà un)
- L'outil de construction de package [sbt](https://www.scala-sbt.org/)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to Wikipedia, the french translation of "build tool" is "moteur de production". I don't think this is necessarily clearer, but that avoids franglais. I'm sure @sjrd has a better suggestion?

- src
- main
- scala (tout votre code Scala doit être placé ici)
- Main.scala (Programme point d'entrée) <-- c'est tout ce dont nous avons besoin pour le moment
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Main.scala (Programme point d'entrée) <-- c'est tout ce dont nous avons besoin pour le moment
- Main.scala (Point d'entrée du programme) <-- c'est tout ce dont nous avons besoin pour le moment

## Ouvrir le projet hello-world

Utilisons un IDE pour ouvrir le projet. Les plus populaires sont IntelliJ et VSCode.
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html)
Il proposent tout deux des fonctionnalités avancées, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html)

## Ouvrir le projet hello-world

Utilisons un IDE pour ouvrir le projet. Les plus populaires sont IntelliJ et VSCode.
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I find the second part of the sentence "..., mais vous pouvez utiliser d'autres éditeurs." a bit weird, as it reads like a restriction or negation.

Suggested change
Il proposent tout deux des fonctionnalités riches, mais vous pouvez utiliser d'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html)
Il proposent tout deux des fonctionnalités riches. D'[autres éditeurs.](https://scalameta.org/metals/docs/editors/overview.html) sont également disponibles.


1. Téléchargez [VSCode](https://code.visualstudio.com/Download)
1. Installez l'extension Metals depuis [la marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals)
1. Ensuite, ouvrez le repertoire contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Ensuite, ouvrez le repertoire contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé.
1. Ensuite, ouvrez le `répertoire` contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé.

1. Installez l'extension Metals depuis [la marketplace](https://marketplace.visualstudio.com/items?itemName=scalameta.metals)
1. Ensuite, ouvrez le repertoire contenant le fichier `build.sbt` (cela doit être le dossier `hello-world` si vous avez suivi les instructions précédentes). Choisissez *Import build* lorsque cela vous est demandé.

> [Metals](https://scalameta.org/metals) est un "Serveur de langage Scala" qui fourni une aide pour écrire du code Scala dans VSCode et d'autres éditeurs [Atom, Sublime Text, autres ...](https://scalameta.org/metals/docs/editors/overview.html), en utilisant le protcole de langage serveur.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> [Metals](https://scalameta.org/metals) est un "Serveur de langage Scala" qui fourni une aide pour écrire du code Scala dans VSCode et d'autres éditeurs [Atom, Sublime Text, autres ...](https://scalameta.org/metals/docs/editors/overview.html), en utilisant le protcole de langage serveur.
> [Metals](https://scalameta.org/metals) est un "Serveur de langage Scala" qui fournit une aide pour écrire du code Scala dans VSCode et d'autres éditeurs [Atom, Sublime Text, autres ...](https://scalameta.org/metals/docs/editors/overview.html), en utilisant le [Language Server Protocol (LSP)](https://microsoft.github.io/language-server-protocol/).

- _build.sbt_
- _src/main/scala/Main.scala_

Quand vous allez lancer votre projet dans l'étape suivante, la configuration dans _build.sbt_ sera utilisé pour lancer le code dans _src/main/scala/Main.scala_.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Quand vous allez lancer votre projet dans l'étape suivante, la configuration dans _build.sbt_ sera utilisé pour lancer le code dans _src/main/scala/Main.scala_.
Quand vous lancerez votre projet à l'étape suivante, la configuration dans _build.sbt_ sera utilisée pour lancer le code dans _src/main/scala/Main.scala_.


1. `cd` vers `hello-world`.
1. Lancez `sbt`. Cela va ouvrir la console sbt.
1. Ecrivez `~run`. Le symbole `~` est optionel, il va relancer l'application à chaque sauvegarde de fichier.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Ecrivez `~run`. Le symbole `~` est optionel, il va relancer l'application à chaque sauvegarde de fichier.
1. Ecrivez `~run`. Le symbole `~` est optionnel, il va relancer l'application à chaque sauvegarde de fichier.


Une fois que vous avez terminé le tutoriel ce dessus, vous pouvez consulter :

* [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fourni un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fourni un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala.
* [The Scala Book](/scala3/book/introduction.html) ([Lien](/overviews/scala-book/introduction.html) vers la version Scala 2), qui fournit un ensemble de courtes leçons et introduit les fonctionnalités principales de Scala.

@mlachkar
Copy link
Contributor

mlachkar commented Dec 9, 2021

@Duhemm I will add your suggestions to a new PR!

byyue pushed a commit to byyue/docs.scala-lang that referenced this pull request Dec 10, 2021
* add fr getting started page

* add small fixes

* add contribution author

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update index.md

* Update _fr/getting-started/index.md

Co-authored-by: Meriam Lachkar <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Meriam Lachkar <[email protected]>

Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Meriam Lachkar <[email protected]>
byyue pushed a commit to byyue/docs.scala-lang that referenced this pull request Dec 10, 2021
* add fr getting started page

* add small fixes

* add contribution author

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Jean Helou <[email protected]>

* Update index.md

* Update _fr/getting-started/index.md

Co-authored-by: Meriam Lachkar <[email protected]>

* Update _fr/getting-started/index.md

Co-authored-by: Meriam Lachkar <[email protected]>

Co-authored-by: Jean Helou <[email protected]>
Co-authored-by: Meriam Lachkar <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants